home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 January / macformat-020.iso / Shareware City / Developers / apps.to.go / AppWannabe / App.h < prev    next >
Encoding:
C/C++ Source or Header  |  1994-05-20  |  4.1 KB  |  120 lines  |  [TEXT/MPS ]
  1. #ifndef __APPHEADER__
  2. #define __APPHEADER__
  3.  
  4. #ifndef __DTSLib__
  5. #include "DTS.Lib.h"
  6. #endif
  7.  
  8. #ifndef __PRINTING__
  9. #include <Printing.h>
  10. #endif
  11.  
  12. #ifndef __TREEOBJ__
  13. #include <TreeObj.h>
  14. #endif
  15.  
  16. /********/
  17.  
  18. #define VH_VERSION  1                /* True means to include ViewHierarchy window.             */
  19. #define DEV_VERSION 1                /* True means allow option-cmd.period escape from dialogs. */
  20.  
  21. /* If you are unfamiliar with programming with the DTS.framework, you probably want to
  22. ** read the file "=How to write your app", which is found at the same level as the
  23. ** directory for this project. */
  24.  
  25. #ifdef powerc
  26. #pragma options align=mac68k
  27. #endif
  28. typedef struct {
  29.     DocHeaderInfo    fhInfo;        /* Doc header info (version, print record, window loc. ) */
  30.     TreeObjHndl        root;
  31.                                 /***** Start of custom file info. *****/
  32. } TheDoc;
  33. #ifdef powerc
  34. #pragma options align=reset
  35. #endif
  36.  
  37. /* Below is the master document structure.  All DTS.framework documents use this structure.
  38. ** For each unique document type, union in a sub-structure for the document-specific
  39. ** information.  In the case of AppWannabe, there is only one known document type initially.
  40. ** The structure for this document type is defined just above.  Even though there is only one,
  41. ** it is still placed in a union.  This allows easy addition of additional document types later.
  42. ** Given a FileRec handle called frHndl, a sample dereference to the inBox field would look like:
  43. **     inBox = (*frHndl)->d.doc.inBox;
  44. **
  45. ** The fileState and connect fields are expected and managed by DTS.framework.  Also, the
  46. ** first two fields in the app-specific portion of the document are expected, namely
  47. ** the fhInfo and root fields. */
  48.  
  49. #ifdef powerc
  50. #pragma options align=mac68k
  51. #endif
  52. typedef struct FileRec {
  53.     FileStateRec    fileState;        /* DTS.Lib expects this structure here. */
  54.     ConnectRec        connect;        /* DTS.Lib expects this structure here. */
  55.     union {
  56.         TheDoc    doc;                /* Union in each document type here. */
  57.     } d;
  58. } FileRec;
  59. #ifdef powerc
  60. #pragma options align=reset
  61. #endif
  62.  
  63. /* Below is the definition of the hierarchical document's root object.  If you are using
  64. ** the hierarchical document package TreeObj, then you will need at least this object.
  65. ** TreeObj expects the first two fields to be undo and frHndl, as shown below.  You can
  66. ** add fields after these two fields.  If you use TreeObj, the root object and all of its
  67. ** children are automatically saved and read from disk.
  68. ** Note that the definition for the root object includes a prototype.  Each object is
  69. ** automatically called by DTS.framework at appropriate times.  The prototype defines the
  70. ** function that will be called for this object.  See the files "=How to write your app"
  71. ** and "=Using TreeObj.c" for more information. */
  72.  
  73. #ifdef powerc
  74. #pragma options align=mac68k
  75. #endif
  76. long    TRootObj(TreeObjHndl hndl, short message, long data);
  77. typedef struct {
  78.     TreeObjHndl    undo;        /* This structure may be added to, but */
  79.     FileRecHndl    frHndl;        /* these two first fields must remain. */
  80. } RootObj;
  81. #ifdef powerc
  82. #pragma options align=reset
  83. #endif
  84.  
  85. /********/
  86.  
  87. #define kMaxNumUndos  64
  88. #define kNumSaveUndos 8
  89.  
  90. #define kNumTreeObjs   16        /* Minimum number of objects is 16. */
  91.  
  92. #define mDerefRoot(hndl)     ((RootObj*)((*hndl) + 1))
  93.  
  94. /********/
  95.  
  96. /* These values are passed to the DTS.framework function Initialize(). */
  97. #define kMinHeap    64 * 1024        /* Needs at least 64k of heap space. */
  98. #define kMinSpace    64 * 1024        /* Needs this much after calling PurgeSpace. */
  99.  
  100.  
  101. #define kwAppWindow    (kwGrowIcon | kwHScrollLessGrow | kwVScrollLessGrow | kwVisible | kwOpenAtOldLoc)
  102.     /* Main application window has growIcon, horizontal and vertical document scrollbars,
  103.     ** is initially visible, and if the document is saved, it will open at the location
  104.     ** it was last closed at. */
  105.  
  106. #define keyAppMessage      'KMSG'         /* Custom Apple Event definitions. */
  107. #define typeAppMessage     'KMSG'
  108. #define typeTextMessage    'KTXT'
  109.  
  110. #define kDisconnectMssg    0
  111. #define kTextMssg        1
  112.  
  113. #define kVersion        100        /* Document versions, not application versions. */
  114. #define kMinVersion        100
  115. #define kMaxVersion        100
  116.  
  117. #define kMaxNumWindows        65535        /* No limit on the number of windows. */
  118.  
  119. #endif
  120.